Skip to content

master: document CPU-aware hot region scheduling#21758

Merged
ti-chi-bot[bot] merged 11 commits into
pingcap:masterfrom
qiancai:docs/cpu-aware-hot-region-scheduling-v857-23140
Jul 6, 2026
Merged

master: document CPU-aware hot region scheduling#21758
ti-chi-bot[bot] merged 11 commits into
pingcap:masterfrom
qiancai:docs/cpu-aware-hot-region-scheduling-v857-23140

Conversation

@qiancai

@qiancai qiancai commented Jul 2, 2026

Copy link
Copy Markdown
Collaborator

This PR is translated from: pingcap/docs#23140

What is changed, added or deleted? (Required)

Document CPU-aware Hot Region scheduling for read hotspots introduced in v8.5.7:

  • Add flow_cpu and cpu-read-rate output descriptions for pd-ctl hot.
  • Add min-hot-cpu-rate, cpu-rate-rank-step-ratio, and CPU-aware read-priorities behavior for balance-hot-region-scheduler.
  • Add troubleshooting guidance for CPU-aware read hotspot scheduling.
  • Add the Store read cpu panel description in the PD Grafana dashboard doc.

Which TiDB version(s) do your changes apply to? (Required)

  • master (the latest development version)
  • v8.5 (TiDB 8.5 versions)

Need cherry-pick to release-8.5 because the feature is requested for v8.5.7.

What is the related PR or file link(s)?

Do your changes match any of the following descriptions?

  • Add a release note
  • Add or modify documentation for a feature

Which TiDB components does this PR affect?

  • TiDB
  • PD
  • TiKV

How do you ensure that your changes are correct? (Required)

  • Checked local /home/lhy1024/pd and /home/lhy1024/tikv implementation for fields, defaults, and version fallback behavior.
  • Ran ./scripts/markdownlint pd-control.md troubleshoot-hot-spot-issues.md grafana-pd-dashboard.md.
  • Ran git diff --check.

@qiancai qiancai added area/scheduling Indicates that the Issue or PR belongs to the area of scheduling. needs-cherry-pick-release-8.5 Should cherry pick this PR to release-8.5 branch. translation/from-docs This PR is translated from a PR in pingcap/docs. v9.0-beta.3 This PR/issue applies to TiDB v9.0-beta.3. labels Jul 2, 2026
@ti-chi-bot ti-chi-bot Bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Jul 2, 2026
@qiancai qiancai self-assigned this Jul 2, 2026
@github-actions
Auto-sync: Update Chinese docs from English PR
5119cca 
Synced from: pingcap/docs#23140
Target PR: pingcap#21758
AI Provider: azure

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

Auto-sync completed successfully

Source PR: pingcap/docs#23140
Target PR: #21758

Chinese documentation has been updated based on English documentation changes.

@ti-chi-bot ti-chi-bot Bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Jul 2, 2026
qiancai
qiancai commented Jul 2, 2026
View reviewed changes
Comment thread pd-control.md Outdated
Comment thread troubleshoot-hot-spot-issues.md Outdated
qiancai
qiancai commented Jul 2, 2026
View reviewed changes
Comment thread troubleshoot-hot-spot-issues.md Outdated
qiancai
qiancai commented Jul 2, 2026
View reviewed changes
Comment thread pd-control.md Outdated
Comment thread troubleshoot-hot-spot-issues.md Outdated
qiancai
qiancai commented Jul 2, 2026
View reviewed changes
Comment thread grafana-pd-dashboard.md Outdated
Comment thread pd-control.md Outdated
qiancai
qiancai commented Jul 2, 2026
View reviewed changes
Comment thread pd-control.md Outdated
lhy1024
lhy1024 reviewed Jul 2, 2026
View reviewed changes

@lhy1024 lhy1024 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the rest LGTM

Comment thread troubleshoot-hot-spot-issues.md
Comment thread troubleshoot-hot-spot-issues.md Outdated
@qiancai @lhy1024
Update troubleshoot-hot-spot-issues.md
d338ebb 
Co-authored-by: lhy1024 <lhylhy1024@gmail.com>
qiancai
qiancai commented Jul 6, 2026
View reviewed changes
Comment thread troubleshoot-hot-spot-issues.md
@qiancai qiancai changed the title pd: document CPU-aware hot region scheduling master: document CPU-aware hot region scheduling Jul 6, 2026
@ti-chi-bot

ti-chi-bot Bot commented Jul 6, 2026

Copy link
Copy Markdown

@lhy1024: adding LGTM is restricted to approvers and reviewers in OWNERS files.

Details

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

qiancai
qiancai commented Jul 6, 2026
View reviewed changes
Comment thread pd-control.md Outdated
qiancai
qiancai commented Jul 6, 2026
View reviewed changes
Comment thread troubleshoot-hot-spot-issues.md Outdated
qiancai
qiancai commented Jul 6, 2026
View reviewed changes
Comment thread pd-control.md Outdated
@qiancai

qiancai commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator Author

/approve

@qiancai qiancai added the lgtm label Jul 6, 2026
@ti-chi-bot

ti-chi-bot Bot commented Jul 6, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: qiancai

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@ti-chi-bot ti-chi-bot Bot added the approved label Jul 6, 2026
@ti-chi-bot ti-chi-bot Bot merged commit 9568cfb into pingcap:master Jul 6, 2026
10 checks passed
@ti-chi-bot

ti-chi-bot commented Jul 6, 2026

Copy link
Copy Markdown
Member

In response to a cherrypick label: new pull request created to branch release-8.5: #21771.

@ti-chi-bot ti-chi-bot mentioned this pull request Jul 6, 2026
Merged
7 tasks
ti-chi-bot Bot pushed a commit that referenced this pull request Jul 6, 2026
@ti-chi-bot
v8.5.7: document CPU-aware hot region scheduling (#21758) (#21771)
411fe3c
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@lhy1024 lhy1024 lhy1024 approved these changes

Assignees

@qiancai qiancai

Labels

approved area/scheduling Indicates that the Issue or PR belongs to the area of scheduling. lgtm needs-cherry-pick-release-8.5 Should cherry pick this PR to release-8.5 branch. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. translation/from-docs This PR is translated from a PR in pingcap/docs. v9.0-beta.3 This PR/issue applies to TiDB v9.0-beta.3.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@qiancai @ti-chi-bot @lhy1024